![GitHub API v3を使ってPull Requestから変更差分のあるファイルの一覧とファイル内容を取得する](https://devio2023-media.developers.io/wp-content/uploads/2019/07/github-eyecatch.png)
GitHub API v3を使ってPull Requestから変更差分のあるファイルの一覧とファイル内容を取得する
こんにちは、CX事業本部の若槻です。
GitHubでは現在REST APIとしてGitHub API v3を使用することが可能です。
今回は、GitHub API v3を使ってPull Requestから変更差分のあるファイルの一覧とファイルの内容の取得をShell(curl)によりしてみました。
やってみた
アクセストークンの発行
まず、GitHub APIアクセス時の認証に使用するOAuth2アクセストークンを発行します。
https://github.com/settings/tokens/new にアクセスしてアクセストークンの新規発行ページを開きます。
[Note]でトークン名(または用途)を入力して、[Select scopes]でrepo
にチェックを入れます。(repo
ではなく、その配下のスコープのみチェックした場合は「List pull requests」の時点でアクセスができませんでした)
同じページ下部の[Generate token]をクリックします。
アクセストークンが新規発行されました。トークン値が表示されるので控えておきます。
GitHub APIアクセス時のお決まり
APIを実際に叩く前に、GitHub APIアクセス時のお決まりについて確認します。
各種APIアクセス時にアカウント固有で共通で必要となる情報は以下となります。これらは変数で予め指定しておきます。
% TOKEN=<先ほど控えたアクセストークン値> % REPOSITORY=<取得するPull RequestがあるRepository名> % OWNER=<RepositoryのOwnerアカウント名>
また、APIホストはhttps://api.github.com
となります。
APIアクセス時にはAccept
ヘッダーを次のように指定して利用するAPIバージョンを明示的に指定することが推奨されています。
"Accept: application/vnd.github.v3+json"
認証が必要なGitHub APIへのアクセス時にはAuthorization
ヘッダーを次のように指定して認証を行います。
"Authorization: token OAUTH-TOKEN"
詳細については次のドキュメントを参照ください。
Pull Requestの取得
ここから実際にAPIを叩いていきます。
まず、変更差分を取得したいPull Requestを取得します。Pull Requestの取得方法には次の2つがありますが、
今回は「List pull requests」により直近で更新されたopen状態のPull Requestを取得してみます。「List pull requests」のメソッドおよびエンドポイントは以下となります。
GET /repos/{owner}/{repo}/pulls
また今回は「List pull requests」で使用可能な以下のParameterを指定します。
state
:open
(Pull Requestの状態をopen
,close
またはall
で指定できる)sort
:updated
(created
,updated
,popularity
またはlong-running
で指定できる)direction
:desc
(ソート方向を指定できる。既定はasc
。)
curlでAPIにアクセスしてPull Request一覧を取得してみます。取得結果は変数pulls
に格納します。
% pulls=$(curl \ -H "Accept: application/vnd.github.v3+json" \ -H "Authorization: token ${TOKEN}" \ "https://api.github.com/repos/${OWNER}/${REPOSITORY}/pulls?state=open&sort=updated&direction=desc")
ここで取得したい情報は直近に更新されたPull Requestの番号です。pulls
からjq
で取得して変数pull_number
に格納します。今回は16
となります。
% pull_number=$(echo $pulls | jq '.[0].number') % echo $pull_number 16
Pull Requestから変更差分のあるファイル一覧を取得
次に先ほど取得したPull Requestの番号を元に、Pull Requestから変更差分のあるファイル一覧を取得します。その場合は「List pull requests files」を使用します。
「List pull requests files」のメソッドおよびエンドポイントは以下となります。
GET /repos/{owner}/{repo}/pulls/{pull_number}/files
curlでAPIにアクセスしてPull Requestから変更差分のあるファイルのファイル一覧を取得してみます。ただしここでは後続の処理で使うためコンテンツURL(contents_url
)を取得します。このコンテンツURLの文字列内にファイルの情報も含まれています。また先ほどと違い変数を介すとURLエンコードが必要な文字が含まれている場合にデコードが面倒なので直接jq
に流し込んでコンテンツURLのリストを変数contents_urls
に格納します。
% contents_urls=$(curl \ -H "Accept: application/vnd.github.v3+json" \ -H "Authorization: token ${TOKEN}" \ "https://api.github.com/repos/${OWNER}/${REPOSITORY}/pulls/${pull_number}/files" | \ jq '[.[].contents_url]')
取得できたコンテンツURLは以下となります。
% echo $contents_urls [ "https://api.github.com/repos/<オーナー名>/<リポジトリ名>/contents/dir1/article.md?ref=301c68a9ebad2c591bdfd0b124f8e4d73175a96a", "https://api.github.com/repos/<オーナー名>/<リポジトリ名>/contents/dir1/dir2/config.json?ref=301c68a9ebad2c591bdfd0b124f8e4d73175a96a" ]
今回はPull Requestでdir1/article.md
およびdir1/dir2/config.json
の2ファイルに差分が発生していることが分かります。またここでref
に指定されている値はPull RequestのHEADの参照を表しています。
変更差分のあるファイルの内容を取得
次に先ほど取得したコンテンツURLを使用して、Pull Requestで変更されたファイルの内容を取得します。
コンテンツURLにアクセスした際のレスポンスでは、ファイルの内容はcontent
にBase64暗号化されて指定されるので復号する必要があります。1つ目のコンテンツURLから復号した内容を取得してみます。
% contents_url=$(echo $contents_urls | jq -r '.[0]') % curl \ -H "Accept: application/vnd.github.v3+json" \ -H "Authorization: token ${TOKEN}" \ "${contents_url}" | jq -r '.content' | base64 -d こんにちは、CX事業本部の若槻です。 今回は、GitHub APIを使ってPull Requestから変更差分のあるファイル一覧を取得してみました。
こんにちは
から始まるファイル内容を取得することができました。
おわりに
GitHub API v3を使ってPull Requestから変更差分のあるファイルの一覧とファイルの内容を取得してみました。
今回確認したGitHub APIを使用して作成したいChrome拡張があったのでこれで何とか作れそうです。作れ次第共有したいと思います。
参考
- Pulls - GitHub Docs
- Repositories - GitHub Docs
- Scopes for OAuth Apps - GitHub Docs
- Resources in the REST API - GitHub Docs
- 変数を使用する | UNIX & Linux コマンド・シェルスクリプト リファレンス
- シェル芸で使いたい jqイディオム - Qiita
- jq コマンドを使う日常のご紹介 - Qiita
- bashで文字列を変数名に展開する方法 - Qiita
- 環境変数の設定を間違えてほとんどのコマンドが "command not found" になってしまったときの対処法 - Qiita
- コマンドラインでURLエンコードをする (他コマンド未使用) - _RJ 技術メモ
- Shellでもbase64 - Qiita
以上